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PREFACE 



t\ This reference manual describes the PREpare LIBrary (PRE LIB) program 

for maintaining and updating MPX Operating System resident and library 
routines. The user's familiarity with the MPX Operating System is assumed. 
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INTRODUCTION 



The PREpare LIBrary (PRE LIB) program is an MPX library program which performs the 
following functions (Figure 1-1): 



C\ 1) Builds an absolute record of the MP-60 emulator program and copies it to the 

MPX system device 

/% 2) Builds an absolute record of the MPX boot program and copies it to the MPX 

^*" system device 

f%, 3) Builds an absolute record of the MPX resident routines and copies it to a user- 

^^ specified file 

4) Creates a new library or updates an existing library of relocatable programs, 
writing the new library to a user-specified file 

5) Builds absolute records of microcode and/or MP-60 relocatable programs and 
copies these to a user-specified unit 

\J! 6) Builds an MPX system tape which can be used for installing the MPX operating 

system 

^J 7 ) Builds an absolute record of an IOC microcode program and copies it to the 

MPX system device 

^Jj 8) Builds an absolute record of the diagnostic microcode program for an IOC and 

copies it to the MPX system device 

\J 9) Builds an absolute record of the CPU diagnostic microcode program and copies 

it to the MPX system device. 
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PRELIB FLOW 



The PRELIB program is separated into 11 modules, one module for each of the 10 functions 
of PRELIB plus a control module (Figure 2-1). 

PRELIB CONTROL 

PRELIB Control receives control immediately after PRELIB is loaded. The basic function 
of PRELIB Control is to read control cards from the standard input unit and pass control 
to the proper module for further processing. All modules return to PRELIB Control when 
they are through processing. PRELIB Control recognizes 17 control cards: 

*MICR - Passes control to the MICE module 

*CNTR0 - Passes control to the CNTR module 

*CNTR1 - Passes control to the CNTR module 

*CNTR2 - Passes control to the CNTR module 

*CNTR3 - Passes control to the CNTR module 

*DIAG0 - Passes control to the DIAG module 

*DIAG1 - Passes control to the DIAG module 

*DIAG2 - Passes control to the DIAG module 

*DIAG3 - Passes control to the DIAG module 

*CPUD - Passes control to the CPUD module 

*BOOT - Passes control to the BOOT module 

*MPX - Passes control to the MPX module 

*LIB - Passes control to the LIB module 

*ABS - Passes control to the ABS module 

*DUMPSYS - Passes control to the DUMPSYS module 

*ALT - Specifies an alternate file/unit for input to PRELIB 

*ENDPLIB - Completes processing and exits back to the MPX operating system 

MICR MODULE 

The MCE module of PRELIB reads a microcode absolute binary deck from the input unit 
and builds an absolute record in core. If no error occurs, the MICE module writes the 
absolute record to the area of the MPX system device reserved for the MP-60 emulator. 
Subsequent deadstarting of the system loads this program as the MP-60 emulator. 
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The MICR module recognizes one control card: 

• *ALT - Specifies an alternate file/unit for input to MICR module 

BOOT MODULE 

The BOOT module of PRE LIB reads an MP-60 relocatable binary deck from the input unit 
and builds an absolute record in core. If no error occurs, the BOOT module writes the 
absolute record to the area of the MPX system device reserved for the MPX boot program. 
Subsequent autoloading of the system loads this program as the MPX boot program. 
The BOOT module recognizes one control card: 

• *ALT - Specifies an alternate file/unit for input to BOOT module 

MPX MODULE 



The MPX module of PRELIB reads MP-60 relocatable binary decks and/or control cards 
from the input unit and builds an absolute record of the MPX resident routines. If no 
error occurs, the MPX module writes the absolute record to a user-specified file. The 
^ MPX module recognizes three control cards: 



• *JMTR - Indicates following relocatable binary decks are the job monitor 
programs 

• *JLDR - Indicates following relocatable binary decks are the job loader programs 

• *ALT - Specifies an alternate file/unit for input to MPX module 

LIB MODULE 



4% The LIB module of PRELIB reads MP-60 relocatable binary decks, control cards, and/or 

^J source cards from the input unit and modifies an existing MPX library or creates a new 

MPX library. If no error occurs, the LIB module writes a new MPX library on a user- 
^\ specified file. The LIB module recognizes seven control cards: 

• ^REPLACE - Replaces a program on the existing library with a new program 

• *DELETE - Deletes a program from the existing library 

• *INSERT - Inserts a new program after a specified program on the existing 
library 

• *DERCT - Builds a loader directory card on the new library with specified 
entry points 

14062200 E 2 _ 3 



o 
o 

o 
o 

• *TEXT - Copies source cards from the input unit to the new library ^^ 

• *ENDT - Stops copying source cards from the input unit to the new library lf\ 

• *ALT - Specifies an alternate file/unit for input to the LIB module 



ABS MODULE 



• *ORIGIN - Builds an absolute record of MP-60 relocatable binary decks which 
follow this card on the input unit 

• *AMICR - Builds an absolute record of the microcode absolute deck which 
follows this card on the input unit 

• *ALT - Specifies an alternate file/unit for input to the ABS module 

DUMPSYS MODULE 



The DUMPSYS module of PRELIB writes a new MPX system tape on a user-specified 
unit. The DUMPSYS module recognizes no control cards. 



CNTR MODULE 
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The ABS module of PRELIB reads microcode absolute binary programs, MP-60 relocatable 

binary programs, and/or control cards from the input unit and builds absolute records, ^j; 

copying these absolute records to a user-specified unit. The ABS module recognizes 

three control cards: 






V . >' 



'<*_>■ 






,-f -> ', 

The CNTR module of PRELIB reads a microcode absolute binary deck from the input unit u '■ 
and builds an absolute record in core. If no error occurs, the CNTR module writes the 
absolute record to the area of the disk reserved for the respective IOC firmware. Sub- _, 

sequent deadstarting of the IOC loads this program as the IOC firmware. The maximum |^ 
number of IOCs a system can configure is four-IOCO, IOC1, IOC2, and IOC3. 

The references to IOC denote an I/O controller, which can be an MPP configured as a (|^ J 
mass storage controller or a unit record controller. The CNTR module recognizes one 

control card: >-> 

• *ALT - Specifies an alternate file/unit for input to the module 4_l 
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o 

o 

o 

_ DIAG MODULE 

o 

OThe DIAG module of PEELIB reads a microcode absolute binary deck from the input unit 
and builds an absolute record in core. If no error occurs, me DIAG module writes the 
absolute record to me area of the disk reserved for the respective DIAG firmware This 
provides the option of deadstarting an IOC with the diagnostic program 
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o 







When PEELIB encounters any of the control cards, *DIAG0, *DIAG1, *DIAG2 or *DIAG<? 
it passes control to the DIAG module. The DIAG module recognizes one control card: ' 

• *ALT - Specifies an alternate file/unit for input to the module 



CPUD MODULE 



[The CPUD module of PEELIB reads a microcode absolute binary deck from the input 
I unit and builds an absolute record in core. If no error occurs, the CPUD module 

J, writes the absolute record to the area of the disk reserved for the CPUD firmware. 

This provides the option of deadstarting the CPU with the diagnostic program. 



When PRELIB encounters this control card, it passes control to the CPUD module. 
This module recognizes one control card: 

• *ALT - Specifies an alternate file/unit for input to the module 
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PRELIB CONTROL CARDS 



All PRELIB control cards have the following format: 

*CCID (Pp P 2 , ...,P n ) 
PRELIB recognizes the following control card identifiers (CCID): 



ABS 

ALT 

AMICR 

BOOT 

CNTRO 

CNTR1 

CNTR2 

CNTR3 

CPUD 

DELETE 

DIAGO 

DIAG1 

DIAG2 



DIAG3 

DIRCT 

DUMPSYS 

ENDPLIB 

ENDT 

INSERT 

JMTR 

JLDR 

LIB 

MICR 

MPX 

ORIGIN 

REPLACE 



TEXT 



p l» p 2» • • » » p n are character strings separated by commas which define parameters for 
the particular control card identifier. All parameters are required unless specified as 
optional. 



'ABS (NABS = lun) 



The control card directs PRELIB Control to enter the ABS module, that is, build absolute 
records of microcode and/or MP-60 relocatable programs and copy these to a user- 
specified unit. 

The term lun is one or two numeric characters identifying the logical unit on which the 
absolute records are to be written. 

Following *ABS on the input unit should be the control cards recognized by the ABS module 
with appropriate binary decks. 
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•ALT (ALT=lun) 

o 



This control card directs the currently operating module to read its input from an alter 
nate unit. The alternate unit is read to end-of-file, end-of-allocated area, or an *ALT 
control card. If end-of-file or end-of-allocated area is encountered, the standard input 
unit, INP, is read for the next control card. The term lun is one or two numeric 
characters identifying the logical unit from which alternate input is to be read. * 

•AMICR (ID=id, FWA=fwct) or *AMICR (NH, FWA=fwa) 



•BOOT (FWA=fwa) 
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This control card is recognized only by the ABS module of PRE LIB. The *AMICR 

control card directs the ABS module to build a microcode absolute record and output it to f^ 

the unit specified on the *ABS control card. If the NH parameter is specified, the absolute %rJ> 

record is built without a header. If the NH parameter is not specified, then the absolute 

record is built with a header, specified by id. j / "~ x ; 

The term id is one to eight alphanumeric characters identifying the absolute record. 



The term fwa is one to four hex characters identifying the first word address of the 
absolute record. This parameter is strictly documentary and does not affect the loading 
of the microcode since it is already in absolute binary format. 

Following *AMICR on the input unit should be the absolute binary deck of the microcode 

program from which the absolute record is built or an *ALT control card designating a ,,—>, 

unit from which the absolute binary microcode can be read. ^ j 



H_y 



€~~ 



This control card directs PRELIB Control to enter the BOOT module, that is, build an <> 

absolute record of the MPX boot program and copy it to the MPX system device. 

The term fwa is one to four hex characters identifying the first word address ^> 

where the MPX boot program is to be relocated. 

Following the *BOOT control card on the input unit should be the MP-60 relocatable "i> 

binary deck of the MPX boot program from which the absolute record is built, an *ALT 
control card designating a unit from which the MP-60 relocatable binary deck can be read, 
or a PRELIB Control control card.^ 






t The alternate unit must be in MPX standard block format (that is 1920 characters \ji 

per block), 
ttlf a PRELIB Control control card follows the *BOOT control card on the input unit, the g~^ 

MPX boot program is copied from the old MPX system tape, designated on the \$ 

*PRELIB control card, to the MPX system device. 



o 



o 
o 

o 
o 
o 
o 



o 

o 
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*CNTRO, *CNTR1, *CNTR2, *CNTR3 

These control cards direct PRE LIB Control to enter the CNTR module; that is, build an 
absolute record of the respective IOC microcode program and copy it to the MPX system 
device. 

Following the *CNTRn, n=0, 1, 2, 3 control cards, on the input unit, should be the micro- 
code absolute binary deck of the respective IOC microcode program, an *ALT control card 
designating an alternate unit from which the IOC microcode binary deck can be read, or a 
PRE LIB Control control card. If a PRE LIB Control control card follows the *CNTR con- 
trol card on the input unit, the IOC microcode program is copied from the old MPX 
system tape, designated on the *PRELIB Control control card, to the MPX system device. 



CPUD 



o 

This control card directs PRELIB Control to enter the CPUD module; that is, build an 
">, absolute record of the CPUD microcode program and copy it to the system device. 

■■ j 

Following the *CPUD control card on the input unit should be the microcode absolute 
a binary deck of the CPUD microcode program, an *ALT control card designating an al- 

*-^ ternate unit from which the CPUD microcode binary deck can be read, or a PRELIB 

Control control card. If a PRELIB Control control card follows the *CPUD control 
0% card on the input unit, the CPUD microcode program is copied from the old MPX system 

*"' tape, designated on the *PRELIB Control control card, to a predefined system device. 



♦DELETE (ID=id) 

This control card is recognized only by the LIB module of PRELIB. The *DELETE 
control card directs the LIB module to copy the old library to new library until program 
identifier id is encountered. The old library is then positioned after the program with 
identifier id. 

The term id is one to eight alphanumeric characters identifying the program to be dele- 
ted from the old library. This identifier is the same as the identifier which appears 
on the E>C card in the MP-60 relocatable binary deck of this program. 

Following the *DELETE control card can be another LIB module control card, a PRELIB 
Control control card, or the MP-60 relocatable binary deck of programs to be copied on 
the new library. 
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*DIAGO, *DIAG1, *DIAG2, *DIAG3 



*DIRCT (DEPT=eptl,ept2,....,eptn) 

This control card is recognized only by the LIB module of PRELIB. The *DIRCT 
control card directs the LIB module to build a loader directory header (LDC) containing 

nonprotected entry points (eptj.eptg eptjj). The loader uses these entry points in the 

LDC at load time for satisfying externals. 

The term ept is one to eight alphanumeric characters identifying entry points which are 
to be entered in the LDC. A maximum of 13 entry points is allowed. All entry points 
must be contained within EPT cards of the MP-60 relocatable binary deck which is 
being copied to the new library. If no *DIBCT card is on input, the LIB module enters 
the entry points (maximum of 13) from the EPT card of the MP-60 relocatable binary 
deck which is being copied. 



*DIRCT (ABSL=PROGNAME,ALT=lu) 

This alternate format of the DIRCT CONTROL CARD is for MPX/OS only, and is used when 
adding absolute modules to the library. This control card directs PRELIB to copy the formerly 
absolutized module named "PROGNAME" found on alternate logical unit "lu"to the library. 

•DUMPSYS (NSYS=lunl,DMPX=lun2,DLIB=lun3,MICR=lun4,BOOT=lun5 / 
CNTR0=lun6,....,DIAG0=lunl0,....,CPUD=lunl4,ID=id) 

This control card directs PRELIB Control to enter the DUMPSYS module, that is, build an 
MPX system tape. 

The term lunl is one or two numeric characters identifying the logical unit for the new 
MPX system tape. 
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This control card directs PRELIB Control to enter the DIAG module; that is, build an 

absolute record of the diagnostic microcode program for the respective IOC and copy it to (Oj 

the MPX system device. ^" 

Following the *DIAG control cards, on the input unit, should be the microcode absolute (fj 

binary deck of the DIAG microcode program, an *ALT control card designating an alternate 
unit from which the DIAG microcode binary deck can be read, or a PRELIB Control control „^ 

card. If a PRELIB Control control card follows the *DIAG control cards on the input unit, ^y 

the respective DIAG microcode program is copied from the old MPX system tape, desig- 
nated on the *PRELIB Control control card, to the MPX system device. 



/0\ 



V v 7 



s \,^ 



4... 



Following the *DIRCT control card on the input unit should be the MP-60 relocatable 

binary deck being copied to the new library or an *ALT control card designating a unit f~" 

from which the MP-60 relocatable binary deck can be read. ^.^ 






o 



© 

o 
c 

The term lun2 is one or two numeric characters identifying the logical unit of the MPX 
-gy resident file to be dumped to the new MPX system tape. The term lun2 must refer to a 

%J/ disk file or an old MPX system tape. 

OThe term lun3 is one or two numeric characters identifying the logical unit of the MPX 
library file to be dumped to the new MPX system tape. The term lun3 must be a disk 
file or an old MPX system tape. 



^ 



The term lun4 is one or two numeric characters identifying the logical unit from which the 
CPU firmware microcode program is dumped. 

The term lun5 is one or two numeric characters identifying the logical unit from which the 
MPXBOOT program absolute code is dumped. 





o 

A 

^ The terms lun6, lun7, lun8, and lun9 are one or two numeric characters identifying the 

logical units from which the microcode programs for I/O controllers 0, 1, 2, and 3, 
#> respectively, are dumped. 

The terms lun 10, lun 11, lun 12, and lun 13 are one or two numeric characters identify- 
ing the logical units from which the diagnostic microcode programs for I/O controllers 
0, 1, 2, and 3, respectively, are dumped. 

The term lunl4 is one or two numeric characters identifying the logical unit from which 
the CPU diagnostic microcode program is dumped. 

f\ The term id is one to eight alphanumeric characters identifying the new MPX system tape. 

*"^ These characters are put into the MPX system tape header. 

O The fields NSYS » DMPX, DLIB, and id are required. The fields MICR and BOOT may be 

ignored; in that case, default disk addresses will be used. Lunl, lun2, and lun3 must also 
be supplied. If any of the optional fields are omitted, the corresponding microcode pro- 

\J S ram w 111 not b e dumped to the new system tape. If any of the optional logical units are 

not supplied, then a default disk address will be used. 

^|) The following files are copied to the new MPX system tape. 

1) MP-60 emulator program is copied from the MPX system device or the logical 

unit number supplied. 

2) MPX boot program is copied from the MPX system device or the logical unit 
W\ number supplied. 



3) 



MPX resident is copied from the MPX resident file specified by the DMPX 
parameter. 



D 

4) The library is copied from the library specified by the DLIB parameter. 

5) The capability of dumping up to four IOC microcode programs, up to four 

diagnostic IOC microcode programs, and the CPU diagnostics program is pro- 



D 
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3-5 • 



Following the *DUMPSYS control card on the input unit should be the next PRE LIB control 
card. 

•ENDPLIB 



•ENDT 



The term id is one to eight alphanumeric characters identifying the program through which 
the old library is to be copied. This identifier is the same as the identifier which 
appears on the IDC card in the MP-60 relocatable binary deck of this program. 

Following the *INSERT control card can be another LIB module control card, a PRELIB 
Control control card, or MP-60 relocatable binary decks of programs which are to be 
copied onto the new library. 

*JLDR(n) 
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o 
o 
o 





This control card directs PRELIB Control to end processing. ,4~^, 






This control card is recognized only by the LIB module of PRELIB. This control card 

directs the LIB module to stop copying source text cards from the input unit to the new ^a 

library. W 

•INSERT (ID=id) Q 

This control card is recognized only by the LIB module of PRELIB. The *INSERT control 
card directs the LIB module to copy the old library to new library through program 
identifier id. 



w 






This control card is recognized only by the MPX module of PRELIB. The *JLDR control ^ , 

card indicates to the MPX module that the MP-60 relocatable binary decks following it 
belong to the job loader portion of MPX resident. 



\y 



The term n is a numeric character (1 through 9) indicating the length in memory pages of 
the job loader. The term n is optional and, if omitted, n is assumed to be 1. 

The *JLDR control card must follow the MP-60'binary relocatable decks of the MPX 
resident program or job manager program on the input unit or an *ALT control card 
designating a unit from which the MP-60 relocatable binary decks of the MPX resident 
program or job manager program were read. 

Following the *JLDR control card on the input unit must be the MP-60 binary relocatable 
decks of the job loader programs or an *ALT control card designating a unit from which 
the MP-60 binary relocatable decks of the job loader programs can be read. jf~> 






C 



o 

o 

o 

O 

o 

The *JMTR control card must follow the MP-60 binary relocatable decka of the MPX 

Orestdent program or Job loader program on the inpnt unit or an .ALT ZZTc^TL- 



o 



C 



o 







o 



*JMTR(n) 

This control card is recognized only by the MPX module of PRELIB. The *JMTR control 
card indicates to the MPX module that the MP-60 relocatable binary decks following it 
belong to the job manager portion of MPX resident. ""owing it 

t T h h e e io e b r L n ^ a T 6 ? CharaCter (1 thr ° Ugh 9) iQdiCating the len # h in memo ^ P^es of 
the job manager. The term n is optional and, if omitted, n is assumed to be 1. 



program or job loader program were read. 

Following the *JMTR control card on the input unit must be the MP-60 binary relocatable 
f. e *™ J manager programs or an *ALT control card designating a unit from which 

the MP-60 binary relocatable decks of the job manager programs can be read. 

*LIB (OL.B=lun1, NLIB=lun2) 



This control card directs PRELIB Control to enter the LIB module, that is, create a new 

library or update an existing library of relocatable programs, writing the new library to 
a user- specified file (refer to Section 5). 



The term lunl is one or two numeric characters identifying the logical unit, either a mass 
storage file or the old MPX system tape, containing the old library. If none is specified, 
it is assumed that a creation of a new library is requested rather than an update of an 
existing library. 

%$ The term lun2 is one or two numeric characters identifying the logical unit on which the 

new library is written. This parameter is required. 

O Following the *LIB control card can be a LIB module control card, a PRELIB Control 

control card, or MP-60 relocatable binary decks of programs which are to be copied onto 

Othe new library. If the card following the *LIB control card is a PRELIB Control control 
card, the old library, specified by the OLIB parameter on the *LIB control card, is 
copied to the new library. 
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The control card directs PRELIB Control to enter the MICE, module, that is, build an 

absolute record of the MP-60 emulator program and copy it to the MPX system device. if\ 

Following the *MICR control card on the input unit should be the microcode absolute 

binary deck of the MP-60 emulator program, an *ALT control card designating an (f\ 

alternate unit from which the MP-60 emulator binary deck can be read or a PRELIB ^ 

Control control card. If a PRELIB Control control card follows the *MICR control card 

on the input unit, the MP-60 emulator program is copied from the old MPX system tape, (O) 

designated on the *PRELIB control card, to the MPX system device. 



,"0\ 



o 



*MPX (NMPX=lun ) 

The control card directs PRELIB Control to enter the MPX module, that is, build an 
absolute record of the MPX resident routines and copy it to a user- specified unit 
(refer to Section 5). 

The term lun is one or two numeric characters identifying the logical unit on which the 
absolute record of the MPX resident routines is to be written. This parameter is 
required. 

Following the *MPX control card can be the MP-60 relocatable binary decks of the MPX 

executive routines, an *ALT control card designating an alternate unit from which the 

MP-60 relocatable binary decks of the MPX executive routines can be read, or a PRELIB 

Control control card. If a PRELIB Control control card follows the *MPX control card 

on the input unit, the MPX resident absolute record is copied from the old MPX system 

tape, designated on the *PRELIB control card, to the user-specified unit. If the MP-60 

relocatable binary decks of the MPX executive routines or the *ALT control card follows (^J 

the *MPX control card, then, following these, on the input unit must also be the *JMTR 

control card and the *JLDR control card (only *JMTR is needed if the job manager and ^ 

job loader are combined into one relocatable binary deck). \y 

•ORIGIN (ID=id, FWA=fwa) {~J 



v. 



/I: 



This control card is recognized only by the ABS module of PRELIB. The *ORIGIN 
control card directs the ABS module to build an MP-60 absolute record header and output 
it to the unit specified on the *ABS control card. 

The term id is one to eight alphanumeric characters identifying the absolute record. 

The term fwa is one to four hex characters identifying the first word address of the ^J^ 

absolute record. 



c 



c 
o 



c 
o 
o 
o 

o 
o 

The term id is one to eight alphanumeric characters identifying the program to be replaced 

Oon the old library. This identifier is the same as the identifier which appears on the IDC 
card in the MP- 60 relocatable binary deck of this program. 

Following the *REPLACE control card must be a *DIRCT control card, the MP-60 
relocatable binary deck of the program(s) which are to replace the program with identifier 
id, or an *ALT control card designating a unit from which the relocatable binaries can 
be read. 



c 

O 
O 







Following *ORIGIN on the input unit should be the MP-60 relocatable binary decks of the 
MP-60 program from which the absolute record is built, or an *ALT control card 
designating a unit from which the MP-60 binary relocatable binary decks of the MP-60 
program can be read. 

'REPLACE (ID=id) 



The control card is recognized only by the LIB module of PRELIB. The *REPLACE 
control card directs the LIB module to copy the old library to new library until program 
identifier id is encountered. The old library is then positioned after the program with 
identifier id. 



•TEXT (ID=id) 

This control card is recognized only by the LIB module of PRELIB. The *TEXT control 
card directs the LIB module to copy source text cards from the input unit to the new 
library until an *ENDT control card is encountered on the input unit. 

O The term id is one to eight alphanumeric characters identifying the source text following 

the *TEXT control card. 

(Q Following the *TEXT control card on the input unit must be the source text to be copied 

to the new library followed by an *ENDT control card. 



o 

o 





14062200 E 3-9/3-10 



o 



o 
o 
o 
o 
c 












c 

J 

o 



o 
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o 
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PRELIB PROCESS DECK STRUCTURE 



MPX CONTROL CARDS 



The PRELIB program is an MPX library program. It is loaded and executed whenever 
the MPX operating system encounters a *PRELEB control card in an input deck. All files 
used by PRELIB must have been previously opened or equipped. Refer to the MPX 

CfS reference manual for a discussion of the control cards necessary for opening and equipping 

* fi un- 



files. 



'PRELIB 



PRELIB is loaded from the MPX library and executed whenever the MPX operating system 
encounters a *PRELIB control card in an input deck. There are two forms for this 
control card: 

*PRELIB 

*PRELIB (OSYS=lun) 



^J The term lun is a logical unit number of an old MPX system tape. This parameter is 

necessary only if subsequent processing requires it. 

^J> The PRELIB control cards and/or binaries which are required for the run follow the 

*PRELIB card in the input deck. 

o 
o 

o 

o 



*JOB(...) 

*SCHED(...) 

*PRELIB 

(PRELIB control deck) 
*EOJ 
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SAMPLE DECK STRUCTURES 



GENERATE NEW MPX SYSTEM TAPE 



*JLDR 

(MPX job loader binaries) 
*DUMPSYS(NSYS=10, DMPX=30, DLIB=20, MICR, BOOT, LD=MPXSTAPE) 
*ENDPLIB 
*EOJ 



o 

o 
o 
o 



The MPX library which is currently operating is copied to logical unit 20, deleting the !l|) 

program deck with identifier PROG1. 

The MPX boot program is absolutized relative to first word address F000 and written to (X J 

the MPX system device. 

The MP-60 emulator program is absolutized and written to the MPX system device. 1 J 



a" 



*JOB(...) 

*SCHED(...) ^ 

*EQUIP(10=MT) ^ 

*OPEN(20,...) 

*OPEN(30,...) 

*PRELIB 

*LEB(OLIB=58,NLIB=20) 

*DELETE(ID=PROGl) ^ ' 

*BOOT(FWA=F000) /"-, 

(MPX boot program binary) 
*MICR 

(MP-60 emulator program binary) 
*MPX(NMPX=30) f~ 

(MPX executive binaries) 
*JMTR /1R 

(MPX job monitor binaries) 



o 
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c 



c 

o 

o 
o 






The MPX executive, job monitor, and job loader binaries are absolutized and written on 
logical unit 30 as the MPX resident. 

The MP-60 emulator program, MPX boot program, MPX resident from logical unit 30, 
and MPX library from logical unit 20 are copied to the new MPX system tape on logical 
unit 10. 



RESTORE MPX SYSTEM 



CThe MP-60 emulator is copied from the MPX system tape on logical unit 10 to the MPX 
! system device. 



The MPX boot program is copied from the MPX system tape on logical unit 10 to the 
MPX system device. 

The MPX resident is copied from the MPX system tape on logical unit 10 to the new 
MPX resident file on logical unit 30. 



j The MPX library is copied from the MPX system tape on logical unit 10 to the new 

^J MPX library on logical unit 20. 



*JOB(...) 

*SCHED(...) 

*EQUIP(10=MT) 

*ALLOCATE (MPX -RESIDENT, . . . ) 

*A LLOCATE (MPX-LIBRARY, . . . ) 

*OPEN(30, MPX-RESIDENT, . . . ) 

*OPEN(20, MPX-LIBRARY, . . . ) 

*PRELIB(OSYS=10) 

*MICR 

*BOOT(FWA=F000) 

*MPX(NMPX=30) 

*LIB(OLIB=10,NLIB=20) 

*ENDPLIB 

*EOJ 
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UPDATE MPX LIBRARY 



O 

o 
o 
o 
o 

The MPX library which is currently operating is copied to logical unit 10, deleting the 
program deck with identifier PROG1. The program deck with identifier PROG2 is copied W 

to logical unit 10 with a directory entry having entry point PROG2EPT. The rest of the %$' 

library is copied to logical unit 10. 

*JOB(...) O 

*SCHED(..„) 

*OPEN(10,...) 

*PRELIB 

*LIB(OLIB=58,NLIB=10) '\J>' 

*DELETE(ID=PROGl) 

*DIRCT(DEPT=PROG2EPT) W 

(PROG2 binary) 
*ENDPLIB 
*EOJ 



BUILD NEW MPX RESIDENT 



The MPX executive, job monitor, and job loader binaries are absolutized and written on 
logical unit 10 as MPX resident. 



c 






* .,.-' 



'*_y 



**,„-••'' 



*JOB(...) r ^ 

*SCHED(...) ^ 



\.> 



o 
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*A LLOCATE (MPX -RESIDENT , . . . ) ^ 

*OPEN(10,MPX-RESIDENT, . . . ) 

*PRELIB 

*MPX(NMPX=10) 

(MPX executive binaries) 
*JMTR 

(Job monitor binaries) 
*JLDR 

(Job loader binaries) 
*ENDPLIB 
*EOJ 

14062200 E 



o 



o 
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o 
o 
o 

o 

D 

o 

c 
o 
o 

o 



GENERATE NEW MP-60 EMULATOR AND COPY 
MPX BOOT PROGRAM FROM MPX SYSTEM TAPE 

The MP-60 emulator program is absolutized and written to the MPX system device. The 
MPX boot program is copied from the MPX system tape on logical unit 10 to the MPX 
system device. 

*JOB(...) 

*SCHED(...) 

*EQUIP(10=MT) 

*PRELEB(OSYS=10) 

*MICR 

(MP-60 emulator binary) 
*BOOT(FWA=F000) 
*ENDPLIB 
*EOJ 

ASSEMBLE AND ADD NEW PROGRAM TO MPX EXECUTIVE ROUTINES 

The new program is assembled by COMPASS and placed on the LGO file (logical unit 57). 

The MPX executive binaries, including the new program from the alternate input unit 57, 
and the job monitor and job loader binaries are absolutized and written on logical unit 10. 



*JOB(. . . ) 
*SCHED(...) 
*OPEN(10, ...) 
*CMP(X, L) 

(ASCII source of program) 
*REWTND(57) 
*PRELIB 
*MPX(NMPX=10) 

(MPX executive binaries) 
*ALT(ALT=57) 
*JMTR 

(Job monitor binaries) 



*JLDR 

(Job loader binaries) 
*ENDPLIB 
*EOJ 
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RESTORE MPX SYSTEM USING ALTERNATE INPUT UNIT 

The control cards and binary decks necessary for restoring the MP-60 emulator, MPX 
boot program, MPX resident, and MPX library are on the alternate input unit 10. 

*JOB(...) 

*SCHED(...) 

*EQUIP(10=MT) 

*ALLOCATE(MPX-RESIDENT, . . . ) 

*ALLOCATE(MPX-LIBRARY, . . .) 

*OPEN(30, MPX-RESIDENT, . . . ) 

*OPEN(20, MPX-LIBRARY, . . . ) 

*PRELIB 

*ALT(ALT=10) 

The following control cards and binaries are on the alternate input unit 10. 

*MICR 

(MP-60 emulator program binary) 
*BOOT(FWA=F000) 

(MPX boot program binary) 



*LIB(NLIB=20) 

(MPX library binaries) 
♦ENDPLIB 

The following control card is on the standard input unit. 

*EOJ 



o 
o 
o 
o 
o 
o 



V.,- 



M._ 



*MPX(NMPX=30) ,«"\ 

(MPX executive binaries) 
*JMTR j~m 

(MPX job monitor binaries) 
*JLDR /jp-, 

(MPX job loader binaries) 
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BUILD MPX INSTALLATION TAPE 

The magnetic tape boot program and MPX installation program are absolutized and 
written on logical unit 10. 

*JOB(...) 

*SCHED(...) 

*EQUIP(10=MT) 

*PRELIB 

*ABS(NABS=10) 

*ORIGIN(ID^rAPEBOOT, FWA=F000) 

(Tape boot binary) 
*ORIGIN(ID=INSTALL, FWA=0000) 

(Install binary) 
*ENDPLIB 
*EOJ 

GENERATE NEW IOC MICROCODE 

The IOC microcode program is absolutized and written to the MPX system device. 

*JOB(. . . ) 
*SCHED(...) 
*PRELIB 
*CNTR0 

(IOC0 microcode binary) 
*ENDPLIB 
*EOJ 
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o 

o 

GENERATE NEW IOC0 AND IOC1 MICROCODE (fj 



The IOCO and IOC1 microcode programs are absolutized and written to the MPX system 
device. 



*OPEN(30, IOCOFID, MPX, 01, ****, R) 

♦PRE LIB 

*DUMPSYS(NSYS=10, DMPX=20, DLIB=58, ID=MPXSTAPE, CNTRO, CNTR1, 
DIAG0=30, CPUD) 

*ENDPLIB 

*EOJ 



o 



*JOB(...) ^ 

*SCHED(. . . ) ^ J ' 

*PRELIB ^rv 
*CNTR0 



^.>' 



(IOCO microcode binary) /■"v 

*CNTR1 

(IOC1 microcode binary) .."~^\ 

*ENDPLIB VV 

*EOJ 

GENERATE NEW MPX SYSTEM TAPE 

H. y 

The MP- 60 emulator program, MPX boot program, MPX resident from logical unit 20, 

MPX library currently operating, the IOCO microcode program, IOC1 microcode program, f""'\ 

DIAGO microcode program from logical unit 30, CPUD microcode program, MP-60 emu- ' % - J/ 

lator microcode program, and MPXBOOT program are copied to the new MPX system tape 

on logical unit 10. ^ 

*JOB(. . . ) 

*SCHED(. . . ) [ %J 

*EQUIP(10=MT) 

*OPEN(20, MPX-RESIDENT, MPX, 01, ****, R) \J 






o 
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o 
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GENERATE NEW DIAGO MICROCODE 

The DIAGO microcode program is absolutized and written to the MPX system device. 

*JOB(. . . ) 
*SCHED(. . . ) 
*PRELIB 
*DIAG0 

(DIAG microcode binary for IOCO) 
*ENDPLIB 
*EOJ 
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FILES AND FORMATS 



MPX SYSTEM DEVICE 

The MPX system device for the MPX operating system is the mass storage unit which con- 
tains one or more IOC controller firmware and diagnostic microcode programs; the MP-60 
emulator; MPXBOOT program, all in absolute form; and may also contain the CPU diag- 
nostic microcode program. The MPX system device also contains the first segment of 
the label file for the MPX system. The label file must start on a logical track boundary. 
Figure 5-1 illustrates the general format for the layout of MPX system device. The 
logical addresses for different device types are listed in the columns to the right of the 
diagram. All microcode programs up to MPXBOOT are a standard disk configuration. If 
any are not applicable, these will be gaps on the disk. Any additional firmware will be 
added in between MPXBOOT and the label file. The address of the label file starts at the 
beginning of the next logical track following the last microcode program. The additional 
microcode programs are allocated at 4,096 32-bit word increments. 
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System 




Device 




Layout 




Device label 




(80 words) 




IOC0 




firmware 




(4K words) 




IOC0 




diagnostics 




(4K words) 




MP-60 CPU 




emulator 




(4K words) 




MP-60 CPU 




diagnostics 




(4K words) 




MPXBOOT 




(4K words) 




Additional 


IOC1 


microcode 


DIAG1 


programs 


IOC2 




- DIAG2 
IOC3 




DIAG3 


Label 




file 




MPX resident 




file 




MPX library 




file 




# User + 
f'space 





Logical Sector Address 



9425 
and 

9427 





844 



858 




MD640 



42 



83 



124 



165 



36 



71 



106 



141 



33 



65 



97 



129 



22 



43 



64 



85 



206 


176 


161 


106 


247 


211 


193 


127 


288 


246 


225 


148 


329 


281 


257 


169 


370 


316 


289 


190 


411 


351 


321 


211 



16 (n+1)' 80 (n+1) 32 (n+1) 36 (n+1) 



Figure 5-1. MPX System Device Layout and Logical Sector Addresses 

* n is the track address for the last microcode program. 
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ABSOLUTE HEADER RECORDS 



Absolute records generated by PRELIB have header records with the following generalized 
format. 





00 




15 


16 




31 




1 


ID 


2 


CHECKSUM 


3 


FWA 


N 


4 




BLKL 



ID - One to eight character identifier for the absolute record 

CHECKSUM - Complemented checksum of the absolute record 

FWA - First word address of absolute record 

N - Number of 4K blocks in the record 

BLKL - Word length of the last block of the record 

MPX RESIDENT 

MPX resident, that is, the MPX executive and job monitor program, resides as a file 
on mass storage in the MPX system. Before calling PRELIB to create an MPX resident 
file, the user must allocate and open the file with the following parameters: 

File Name - MPX-RESIDENT 

Owner - MPXR 

Access Privacy - **** 

Block Size - 1 

Segmentation - NS 
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Since MPX resident resides as a file, a user may have several editions of MPX resident 
on mass storage at the same time. At autoload time, the user specifies the edition 
number of the MPX resident file he wishes to execute. 



MPX Resident File Header 



MPX Resident in Absolute Format 



The identifier in the MPX resident file header is *MPXRESD. 



MPX LIBRARY 



o 
o 
o 
o 
o 






MPX library, that is, binary decks of user routines and programs, resides as a file on 
mass storage in the MPX system. Before calling PRE LIB to create a MPX library file, 
the user must allocate and open the file with the following parameters: 

File Name - MPX-LIBRARY 

Owner - MPXL 

Access Privacy - **** 

Block Size - 480 words 

I The MPX library (Figure 5-2) is created using the MPX logical I/O routines, blocker/ 
deblocker. The MPX library consists of a series of binary records. (Refer to the 
loader section of the MPX reference manual for a discussion of the records.) The MPX 
library is searched at load time by the system loader for unsatisfied externals. 



Loader Directory Card 



Binary Deck 



Loader Directory Card 



Binary Deck 



Loader Directory Card 



Figure 5-2. MPX Library File 
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D 



Each loader directory card in the library has a pointer to the block containing the next 
loader directory card. The last loader directory card in the library has a pointer of 
zeros signifying end of the library. 

MPX SYSTEM TAPE 

The MPX system tape (Figures 5-3 and 5-4) contains all of the information necessary for 
installing the MPX operating system. The system tape format depends upon the optional 
parameters on the *DUMPSYS control card. 



System Tape Header 



EOF 



MP-60 Emulator (4K) 



EOF 



MPX BOOT Header 



MPX BOOT 



EOF 



MPX Resident Header 



MPX Resident 



EOF 



MPX Library 



EOF 



EOF 



Figure 5-3. MPX Sample System Tape 
(No optional fields) 
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System Tape Header 



EOF 



MP-60 Emulator 



EOF 



IOCO Header 



IOCO 



EOF 



DIAGO Header 



DIAGO 



EOF 



CPUD Header 



CPUD 



EOF 



MPXBOOT Header 



MPXBOOT 



EOF 



IOC1 Header 



IOC1 



EOF 



DIAG1 Header 



DIAG1 



EOF 



MPX Resident Header 



MPX Resident 



EOF 



MPX Library 



EOF 



EOF 



Figure 5-4. MPX Sample System Tape 
(Two IOC, two DIAG and one CPUD programs) 
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* 


M 


P 


X 


s 


Y 


S 


T 


ID 



The first file on the MPX system tape consists of a header record with the following 
format. 



1 

2 

3 

ID - One- to eight-character identifier corresponding to the ID parameter on the *DUMPSYS 
card. 

The second file on the MPX system tape is the MP-60 emulator written in absolute format 
as one 4K word block. 

The next group of files are variable and may include IOCO, IOC1, IOC2, IOC3, DIAGO, 
DIAG1, DIAG2, DIAG3, and CPUD (programs written to the devices to provide 
deadstarting of the IOCs and CPUs). Each of these files is written in absolute format as 
one 4K block plus a header record. 

Following these files (if they exist), on the MPX system tape, is the MPX boot program 
in absolute format with a header record. 

Following the MPX boot file on the MPX system tape is the MPX resident programs in 
absolute format with a header record. 

Following the MPX resident file on the MPX sustem tape is the MPX library written as 
480 word blocks. 

PRELIB SCRATCH FILE 



PRELIB uses one scratch file, logical unit 59. The user should use caution when 
utilizing scratch in a job process which calls PRELIB. 
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PRELIB DIAGNOSTICS 



All PRELIB diagnostics appear on the standard output unit, OUT, and have the following 
format: 

***** MODULE message 

The module is 1 through 8 characters identifying the PRELIB module currently executing 
when the error occurred. 

Table 6-1 lists PRELIB diagnostics, their causes, and action taken by PRELIB, if any. 

TABLE 6-1. PRELIB DIAGNOSTICS 



Message 


Cause 


Action 


BINARY CARD 


Binary card was 


Processing continues with next 




encountered when 


valid control card 




ASCII card was 






expected 




CHECKSUM ERROR XX 


Checksum error 


Processing continues 


PROGRAM XXXXXXXX 


occurred on card XX 
in binary deck of 
program XXXXXXXX 




INVALID CONTROL CARD 




Processing continues with next 
valid PRELIB Control control 
card 


ILLEGAL HEX CHARACTER 


Illegal hex character 


Processing continues with 




was encountered in 


next valid control card 




absolute microcode 






deck 




ILLEGAL PARAMETER 




If on *PRELIB card, job aborts; 
otherwise, processing continues 
with next valid control card 


LIBRARY CREATION RUN 


LIB module encountered 


Processing continues with next 




a LIB control card 


valid control card 




which references an old 






library when none was 






specified 
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TABLE 6-1. PRE LIB DIAGNOSTICS (Cont.) 



Message 


Cause 


Action 


LOAD ERROR 


Loader error occurred; 


Processing continues with next 


error message 


error messages are 
MPX loader errors 
(Section 9 of MPX 
Reference Manual) 


valid control card 


LOAD MEMORY EXCEEDED 


Boot program larger 


Processing continues with 




than 4K. Absolute 


next valid control card 




microprogram larger 






than 4K 




LOADER CORE EXCEEDED 


Not enough memory 


Processing continues with 




available to PRE LIB 


next valid control card 




to absolutize program 




LUN INVALID 




If *PRELB3 card, job aborts; 
otherwise, processing 
continues with next valid 
control card 


LUN XX ILLEGAL DEVICE 




If *PRELIB card, job aborts; 
otherwise, processing 
continues with next valid 
control card 


LUN XX ILLEGAL FORMAT 


Logical unit is not 


Processing continues with 




in format expected 


next valid control card 


LUN XX NOT EQUIPPED 




If *PRELIB card, job aborts; 


OR OPEN 




otherwise, processing 
continues with next valid 
control card 


MORE THAN 13 ENTRY 


LIB module was directed 


The first 13 entry points are 


POINTS 


to enter more than 13 


entered and processing 




entry points on loader 


continues 




directory card 




NO BINARY 


Binary deck was 


Processing continues with 




expected 


next valid control card 


NO ENDPLIB 


End-of-file was 
encountered on standard 
input unit 


PRE LIB terminates normally 
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TABLE 6-1. PRE LIB DIAGNOSTICS (Cont.) 



Message 



NO ENDT 



NO ENTRY POINT 
XXXXXXXX IN 
PROGRAM XXXXXXXX 



NO MICRO DECK 



NO OLD SYSTEM TAPE 



Cause 



NO PROGRAM XXXXXXXX 



NO JMTR 



NO TEXT 



PARAMETER APPEARS 
TWICE 

PARAMETER REQUIRED 



14062200 A 



LIB module encountered 
another control card 
before encountering 
*ENDT control card 

Named entry point was 
on *DIRCT card but 
not on EPT in binary 
deck 

Absolute microdeck 
was expected 

Old system tape is 
required but was not 
specified on *PRELIB 
card. 

Program specified on 
LIB module control 
card is not on old 
library 

MPX module did not 
encounter a *JMTR 
control card 

Lib module encountered 
an *ENDT control card 
when a *TEXT control 
card had never been 
read 



Parameter which is 
required is missing 



A ction 



Processing continues with 
next valid control card 



Processing continues 



Processing continues with 
next valid control card 

Processing continues with 
next valid PRE LIB Control 
control card 



Processing continues with 
next valid control card 



Processing continues with 
next valid PRE LIB Control 
control card 

Processing continues with 
next valid control card 



Processing continues 



Processing continues with 
next valid control card 
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TABLE 6-1. PRELIB DIAGNOSTICS (Cont.) 



Message 


Cause 


Action 


PACK 1 

PACKD > ERR ON XX 

PACKD J 




Job aborts 


STATUS = XXXXXXXX 






PICK "I 

PICKD k ERR ON XX 

PICKI J 




Job aborts 


STATUS = XXXXXXXX 






PROGRAM ERROR 

OCCURRED AT XXXX 


Unexplained condition 
occurred in PRELIB 
program at address 
XXXX 


Job aborts 


ss£?}*»«= 




Job aborts; if XX = 00, error 
was on the MPX system 
device 


STATUS = XXXXXXXX 






SEQUENCE ERROR, 
LAST CARD XXXXX 
CURRENT CARD XXXXX 


Microcode absolute 
binary deck out of 
sequence 


Processing continues with next 
valid PRELIB Control control 
card 


VERIFY ERROR ON 
SYSTEM TAPE 


MPX system tape which 
was just generated 
failed to verify 


Processing continues with 
next valid control card 


NO CPUD ON OLD SYSTEM-. 
TAPE 






NO DIAGO ON OLD SYSTEM 
TAPE 

NO DIAG1 ON OLD SYSTEM 
TAPE 

NO DIAG2 ON OLD SYSTEM 
TAPE 


The requested programs 
are not on the MPX 
system tape 


Processing continues with 
next valid control card 


NO DIAG3 ON OLD SYSTEM 
TAPE 






NO IOCO ON OLD SYSTEM 
TAPE 
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TABLE 6-1. PEELIB DIAGNOSTICS (Cont. ) 


© 


Message 


Cause 


Action 


NO IOC1 ON OLD SYSTEM^ 
TAPE 

NO IOC2 ON OLD SYSTEM 
TAPE 


> 


The requested programs 
are not on the MPX 
system tape 


Processing continues 
with next valid control 
card 




NO IOC3 ON OLD SYSTEM 
TAPE ^ 
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ABS module 

Absolute header records 

*ALT 
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*BOOT 

BOOT module 
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CPUD module 
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